home *** CD-ROM | disk | FTP | other *** search
/ Amiga Plus 1995 #3 & #4 / Amiga Plus CD - 1995 - No. 3 and 4.iso / pd / packer / archandler / archandler.txt < prev    next >
Text File  |  1995-07-20  |  15KB  |  333 lines
  1.  
  2.                               ARCHandler 2.0a
  3.                              =================
  4.  
  5.          ARCHandler is Copyright © 1994, 1995 Rafael D'Halleweyn.
  6.                            All rights reserved.
  7.  
  8.  
  9. 0. Contents
  10. -----------
  11.  
  12.   1. Introduction
  13.   2. Distribution
  14.   3. History
  15.  
  16. For  full  documentation  you  should  read the included AmigaGuide (in the
  17. `Help' drawer).
  18.  
  19.  
  20. 1. Introduction
  21. ---------------
  22.  
  23. ARCHandler  installs  a filesystem that gives you transparent access to the
  24. files in archives: you can read, view and execute those files/programs from
  25. archives without the need to extract them first.
  26.  
  27. You can test the program without installing it first, just double-click the
  28. `ARCHandler'.
  29.  
  30. When  you  have  decided  to install ARCHandler you should use the included
  31. `Install' script. It needs the Commodore `Installer' program. The Installer
  32. program  should  be somewhere in your path. You can use the `Remove' script
  33. to deinstall ARCHandler.
  34.  
  35. The `Script' drawer contains several scripts for directory utilities. These
  36. are not installed by the Install script.
  37.  
  38.  
  39. 2. Distribution
  40. ---------------
  41.  
  42. This package is released as shareware. This means you can copy it freely as
  43. long  as  you  don't ask any money for it, except perhaps a nominal fee for
  44. copying.  If  you  use this package on a regular base, you should send me a
  45. contribution of 500 BEF or USD 20. Send money by International Money Order,
  46. EuroCheck (in BEF!) or Cash.
  47.  
  48. Magazines that want to include ARCHandler on their coverdisk(s) should also
  49. register  ARCHandler  (one  registration fee) and send one free copy of the
  50. magazine (including disks) to the author.
  51.  
  52. The  package  is  Copyright  © Rafael D'Halleweyn, All Rights Reserved. The
  53. author  reserves the right to change the status of this package whenever he
  54. finds it appropriate.
  55.  
  56. This  package  should  not  be  spread  in  any  other form than an LhA (or
  57. equivalent)  archive  and  all  parts  of it should be spread together. The
  58. package  may  not  be  altered in any way and cannot be used for commercial
  59. purposes  without  the  prior written permission of the author. The archive
  60. should contain the following files:
  61.       ARCHandler (dir)
  62.           ARCFiles
  63.             Disk.info
  64.             Drawer.info
  65.             Volume.info
  66.           C (dir)
  67.             FindCommand
  68.             FromARC
  69.             PrefLanguage
  70.             StartARC
  71.             StartARC.info
  72.             ToARC
  73.           Catalogs (dir)
  74.             «language» (dir)
  75.               archandler.catalog
  76.             ...
  77.             archandler.cd
  78.           Help (dir)
  79.             «language».info
  80.             «language» (dir)
  81.               ARCHandler.guide
  82.             ...
  83.             Pictures (dir)
  84.               ARCHandlerCxPrefs.pic
  85.               ARCHandlerDevPrefs.pic
  86.               ARCHandlerKeyReq.pic
  87.               ARCHandlerMain.pic
  88.           Scripts (dir)
  89.             FromARC.dmrx
  90.             FromARC.dopus
  91.             Scripts.txt
  92.             Scripts.txt.info
  93.             ToARC.dmrx
  94.             ToARC.dopus
  95.         ARCHandler
  96.         ARCHandler.info
  97.         ARCHandler.txt
  98.         ARCHandler.txt.info
  99.         ARCHandler_small
  100.         ARCHandler_small.info
  101.         Help.info
  102.         Install
  103.         Install.info
  104.         Remove
  105.         Remove.info
  106.         Scripts.info
  107.     ARCHandler.info
  108.  
  109. Distribution  of  the program on any medium (CD, floppy, ...) in such a way
  110. that  it is ready to be used (eg. as a front-end for a CD-ROM) requires the
  111. permission of the author.
  112.  
  113. The   installation-script  (`Install')  and  the  extra  commands  it  uses
  114. (`FindCommand',  `PrefLanguage'  and  `StartARC')  are also copyrighted and
  115. can't  be  used  in  any  other  project/archive  without the prior written
  116. permission of the author.
  117.  
  118.  
  119. 3. History
  120. ----------
  121.  
  122. ===========================================================================
  123.  
  124.   ·release 1.0 [37.129 (12.7.94)]
  125.     -First release.
  126.  
  127.   -----------------------------------------------------------------------
  128.  
  129.   ·release 1.0a [37.131 (14.7.94)]
  130.     -Volumes  that  have  the  same  name as a device couldn't be used
  131.      through the handler (reported by Erik Bergen).
  132.     -Removed a nasty Enforcer hit.
  133.     -Made some changes to the installation script.
  134.  
  135. ===========================================================================
  136.  
  137.   ·release 1.1 [37.157 (21.8.94)] «never released»
  138.     -ARCHandler now uses it's own routine to list  lha-archives.  As a
  139.      result, ARCHandler no longer  needs the PIPE-device.  The strange
  140.      files, that sometimes showed up, should also be gone.  Listing is
  141.      now also a bit faster.
  142.     -Files  are now  extracted much  faster (upto 5  times faster  for
  143.      small files like icons).
  144.     -ARCHandler won't start to list an archive when another process is
  145.      already listing the same archive.
  146.     -Added a '.backdrop' file  to the root of the filesystem.  Now you
  147.      can permanently leave out files and drawers.
  148.     -The  handler  now  supports  ACTION_COPY_DIR_FH  (DupLockFromFH),
  149.      ACTION_EXAMINE_FH (ExamineFH), and ACTION_PARENT_FH (ParentOfFH).
  150.      Suggested  by  Nicola  Salmoria  and  Matthias Scheler. Currently
  151.      these  packets only work with normal files and files in archives,
  152.      they  don't  work  with  the extra icons the handler produces nor
  153.      with the backdrop-file.
  154.     -ARCHandler  now adds a '/' to TEMPDIR  when there wasn't one (LhA
  155.      needs this). Suggested by Tattoo Mabonzo.
  156.     -ARCHandler no  longer  uses  LhA  to extract  uncompressed  files
  157.      (`-lh0-'), this should speed up access to archives in archives.
  158.     -Added a new startup-option:  ONLYEXT;  when you use  the ONLYEXT-
  159.      option,  ARCHandler  will  only  check  the filename-extension to
  160.      decide on the filetype (suggested by Nicola Salmoria).
  161.     -Some  preparations  for a writable  filesystem  and some  general
  162.      fixes.
  163.     -ARCHandler now  returns a `disk not validated'-error when there's
  164.      something wrong with an archive or with LhA.
  165.     -The  handler  now  adds  DISKINSERTED/DISKREMOVED  events to  the
  166.      input  stream  when it's started/removed. This way, the Workbench
  167.      notices the new volume faster.
  168.     -Added  two  support commands for shell users,  ToARC and FromARC.
  169.     -The  DISKICON  and  DRAWERICON  arguments  may  now  be  upto  96
  170.      characters.
  171.     -`Smarter' installation script.
  172.     -Added ToARC and FromARC scripts for DiskMaster.
  173.  
  174. ===========================================================================
  175.  
  176.   ·release 2.0 [37.290 (3.2.95)]
  177.     -ARCHandler  is  no  longer  a real handler (one that lives in the
  178.      'L:'  directory).  Instead,  ARCHandler is now a program, you can
  179.      place it everywhere, even in your WbStartup directory.
  180.     -The most visible  change is the  graphical user  interface (GUI).
  181.      The  GUI  is  fully  font/locale  sensitive.  Almost  all  of the
  182.      settings  can be changed (and saved) with this GUI (you no longer
  183.      have  to  mess with the `Startup' field). The settings that can't
  184.      be  changed with the GUI are set while installing ARCHandler. The
  185.      GUI has context sensitive online-help.
  186.     -The  internals  of  the handler have completly been rewritten. It
  187.      now  uses  coroutines  to  implement a multi-threaded filesystem:
  188.      there's  no longer a need for extra processes to complete packets
  189.      (an  ACTION_FINDINPUT  of  an  archive  will  still need an extra
  190.      process   since   LhA   can't  be  used  in  this  multi-threaded
  191.      environment, the same is true for the filerequesters).
  192.     -ARCHandler is now also a commodity, with a `Hot Key' and a `Flush
  193.      Key'.
  194.     -Instead  of  scanning  the  DosList  on every ACTION_EXAMINE_NEXT
  195.      packet,  ARCHandler  now scans the DosList every x seconds (x can
  196.      be changed).
  197.     -ARCHandler  also  listens to DISKINSERT, DISKREMOVED events. Both
  198.      events  will  trigger  a  rescan  of the DosList. ARCHandler also
  199.      checks the list of archives, when it finds an archive that exists
  200.      on  a  removed volume, the archive will be freed if it was not in
  201.      use  (or if it is in use, it will be freed when the archive is no
  202.      longer in use).
  203.     -The `FlushARC' command  is  gone, there's now a `Flush Key' and a
  204.      'Flush'  gadget. The use of the DISKINSERT and DISKREMOVED events
  205.      should  also  replace  some  uses of this command. The `FlushARC'
  206.      command  will  no longer work, please delete it if you still have
  207.      it.
  208.     -All  the  extra files that ARCHandler needs are now placed in one
  209.      directory  (default is `PROGDIR:ARCFiles'). This directory should
  210.      contain  a `Volume.info', resp. a `Drawer.info' if you want icons
  211.      for volumes without a disk-icon, resp. icons for archives.
  212.     -Non-archive   files   are   now   writable.  The  default  volume
  213.      `Disk.info'  and the icon for the archives are also writable (the
  214.      position information of the icon is ignored).
  215.     -ACTION_LOCATE_OBJECT  (Lock()) supports exclusive  (ACCESS_WRITE)
  216.      locks.
  217.     -The filesystem now has full support for the following packets:
  218.        ACTION_COPY_DIR_FH;
  219.        ACTION_EXAMINE_FH;
  220.        ACTION_FH_FROM_LOCK;
  221.        ACTION_PARENT_FH and
  222.        ACTION_RENAME_DISK.
  223.      It also has partial support for the following packets:
  224.        ACTION_CHANGE_MODE;
  225.        ACTION_FINDOUTPUT;
  226.        ACTION_FINDUPDATE;
  227.        ACTION_DELETE_OBJECT;
  228.        ACTION_RENAME_OBJECT;
  229.        ACTION_SET_COMMENT;
  230.        ACTION_SET_DATE;
  231.        ACTION_SET_OWNER;
  232.        ACTION_SET_PROTECT;
  233.        ACTION_SET_FILE_SIZE.
  234.     -ARCHandler  should  now  also work correctly on systems using the
  235.      MultiUser FileSystem (muFS). I hope to add full MultiUser support
  236.      in  a  future  version.  The  only  thing  that has to be done is
  237.      access-checking.  ACTION_EXAMINE_OBJECT  and  ACTION_EXAMINE_NEXT
  238.      should already return the correct protection/file owner, even for
  239.      the virtual files (icons), these are always owned by root and are
  240.      readable by all, but only changeable by root.
  241.     -The  ARCHandler  archive  contains  NewIcons. You won't see these
  242.      icons  unless  you  have  the  NewIcons package installed. If you
  243.      don't  have  the  NewIcons  package  installed you can remove the
  244.      `IM1'  and  `IM2'  tooltypes.  NewIcons  was  written  by  Nicola
  245.      Salmoria, the artwork is based on work by Roger McVey.
  246.  
  247.   -----------------------------------------------------------------------
  248.  
  249.   ·release 2.0a [37.312 (11.4.95)]
  250.     -Because of the low number of new registrations I have been forced
  251.      to  protect my  hard  work  with a  key file.  Everybody who  has
  252.      registered  should already have his/her key file. An unregistered
  253.      copy  will  pop  up the main ARCHandler window from time to time.
  254.      The  KEEPTIME  (see  further) and BUFFERS arguments are sometimes
  255.      reset to zero. Using an illegal key file is DANGEROUS!
  256.     -When  an extracted  file is closed  it isn't immediatly  deleted.
  257.      When  the same  file is  opened  again in a short  time, the file
  258.      doesn't have to  be reextracted.  This speeds  up access  through
  259.      MultiView and directory  utilities.  The time a file  is kept can
  260.      be changed with the KEEPTIME  argument/tooltype  (defaults to two
  261.      seconds). There's no slider to change it yet.
  262.     -You  can  now  use  devices  and assigns in the root directory. A
  263.      device  will  be expanded to its volume (if it has one, otherwise
  264.      it  will  fail),  an  assign  will  be expanded to its path (only
  265.      binding,  non-late  assigns,  using  the  first  part  of a multi
  266.      assign).
  267.     -Sometimes an archive whose  contents wasn't yet completely parsed
  268.      was already flushed.  This generated several Enforcer hits.  This
  269.      error only occured under  very rare conditions  and was very hard
  270.      to find.
  271.     -ARCHandler has never been able to use directories deeper then 254
  272.      levels (that should be enough), but it never checked if you tried
  273.      to  go  deeper  (you  almost never do). ARCHandler will no longer
  274.      allow  you  to  go  any deeper, it will return with an error "too
  275.      many levels".
  276.      This  only  gave  problems  when  you  used the Workbench to copy
  277.      `Archives:Ram  Disk'  to `Ram Disk'. This resulted in a very long
  278.      chain  of  directories `Ram Disk:Ram Disk/Ram Disk/...', that way
  279.      you quickly reached the 254 limit.
  280.     -You can now rename archives.  I also changed  (fixed?) some other
  281.      renaming stuff.
  282.     -ARCHandler could lock up  when you used it to access  archives in
  283.      archives (ie. Archives:Archives/Work/arc1.lha/arc2.lha/file.txt).
  284.     -Fixed some things that could cause an Enforcer hit.
  285.     -Fixed  something  in the  multithreading  that could  have messed
  286.      things up pretty badly.
  287.     -After using an archive in an  archive you no longer have to flush
  288.      before you can quit.
  289.     -Slashes  are  removed  from  the  start  of  directory  names  in
  290.      archives.
  291.     -The key up events were  also used when  you used the  keyboard to
  292.      change a  slider  or a  checkbox  (causing  a slider  to move two
  293.      positions).
  294.     -Device   Preferences  wouldn't   show  the  actual   priority  of
  295.      ARCHandler  (ie.  you  used a utility  to change  the priority of
  296.      ARCHandler).
  297.     -When you  had seeked  through a  volume icon  in the root  of the
  298.      filesystem  ARCHandler  no longer  changed  the icon  to a drawer
  299.      icon. This shows when  you are using PDPro.  Reported by Kaikumaa
  300.      Timo.
  301.      While testing ARCHandler with  PDPro I had several other crashes,
  302.      I still  had crashes  when ARCHandler  was NOT running!  I do not
  303.      recommend using PDPro together with ARCHandler!
  304.     -Small problem fixed that happened when a file extraction failed.
  305.      ARCHandler  now  returns  an ERROR_OBJECT_NOT_FOUND when it finds
  306.      that  the archive is corrupt. The Workbench didn't like the other
  307.      errors.
  308.     -ARCHandler couldn't be started from ToolManager, fixed.
  309.     -Using ASLFR_DoSaveMode tag for directory requesters.  This allows
  310.      you to create new drawers from within the directory requesters.
  311.     -An exclusive lock in an archive wasn't correctly unlocked.
  312.     -Recompiled with SAS-C 6.55.
  313.     -Split Installer options in two so that they are all visible.
  314.     -Install script  forgot to add 'LhA'  to the path it  got from the
  315.      user when it couldn't find 'LhA' by itself.
  316.     -Included German translations by Martin Stengle. Thanks Martin.
  317.     -Included French translations by Florent Monteilhet. Thanks.
  318.     -Removed  some mistakes reported by Erik Bergen from the guide and
  319.      the installation script
  320.  
  321.   -----------------------------------------------------------------------
  322.  
  323.   ·future release
  324.     -Fully  writable  filesystem,  with  the ability to create/change
  325.      files in archives.
  326.     -Support for more archive types (zip/zoo/tar/...).
  327.     -Support for crunched files (XPK/PowerPacker/Imploder/...).
  328.  
  329. These  are  just  some  of  the features I might add to a future release. I
  330. don't  guarantee that any of these features will ever be implemented (but I
  331. hope  they  will). If you've got any good ideas for a future release let me
  332. know.
  333.